home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / mr2i129.zip / READ.ME < prev    next >
Text File  |  1997-06-11  |  21KB  |  511 lines

  1. MR/2 ICE v1.29 - An Internet EMail Client for OS/2 PM.
  2.  
  3. Copyright (c) 1996, 1997 Knightware Software Company.
  4. All rights reserved.
  5.  
  6. See UPGRADE.TXT for information on how to update an existing install.
  7.  
  8. ================== 
  9. Table of Contents
  10. ==================
  11.  
  12. 1.  Release Information.
  13. 2.  Shareware Notice and Ordering Instructions.
  14. 3.  Credits
  15. 4.  List of major features.
  16. 5.  Quick start instructions.
  17. 6.  Known bugs/problems/missing features.
  18. 7.  Contacting the Author.            
  19.  
  20. Release History has been moved to the file "history.txt"
  21. See README.1ST for an overview of readable text files included.
  22. See INSTALL.TXT for installation issues.
  23.  
  24. =================================
  25. 1-RELEASE INFORMATION - 01/23/97
  26. =================================
  27.  
  28. Thank you for trying the latest addition to the MR/2 family of 
  29. electronic messaging software for OS/2 ... the MR/2 Internet Cruiser 
  30. Edition.  MR/2 ICE is an Internet EMail client.  It can read mail via a 
  31. POP3 mail server and/or has direct SMTP hooks available.  
  32.  
  33. For those of you who know my work already, you know that I like to have 
  34. lots of options, including optional pieces of the user interface.  I 
  35. have attempted to continue this theme with MR/2 ICE.  You'll find things 
  36. like toolbars and status bars configurable, even to the point of 
  37. hiding them.
  38.  
  39. There are no limits to the "shareware" version.  I don't like 
  40. crippleware, but I will no doubt offer some incentive to register, or 
  41. add a minor anoyance or two if you don't.  Right now there is none of 
  42. this.
  43.  
  44. MAILING LIST:  Send email with SUBSCRIBE in the subject to
  45. mr2ice.list@secant.com
  46.  
  47. SEE MY WEB PAGE at http://nick.secant.com for late-breaking news.
  48.  
  49. THE OFFICIAL MR/2 ICE FAQ page is available as link from my
  50. WWW home page, listed above.
  51.  
  52.  
  53.  
  54. =============================================
  55. 2-Shareware Notice and Ordering Instructions
  56. =============================================
  57.  
  58. N O T I C E
  59. -----------
  60.  
  61. This IS a shareware package, and does require a registration fee if
  62. you choose to continue using it after 30 days.  The registration
  63. fee for this product is currently $30 US. A later version may
  64. include a newsreader, and price will increase slightly ($40?).
  65.  
  66. Register by filling out and mailing (or faxing, if paying by credit
  67. card) REGISTER.DOC to me.
  68.  
  69. NOTE:  Registration letters are sent out via email within a week of
  70. arriving to me; often sooner.  If you don't get a letter, write.  They
  71. sometimes get lost in email-limbo, and I will happily resend.
  72.  
  73.  
  74. NEW WAY TO REGISTER - OS/2 SHAREWARE BBS
  75. ----------------------------------------
  76. You can now register MR/2 ICE via the OS/2 Shareware BBS, online.
  77. The system accepts most major credit cards (Mastercard, Visa, American
  78. Express and Discover card).  Use your modem to call the OS/2 Shareware
  79. BBS at (703) 385-4325 or telnet into os2bbs.com.
  80.  
  81.  
  82. ORDER THROUGH BMT MICRO!!!
  83. --------------------------
  84. Credit card orders can be placed with BMT Micro at 1-800-414-4268
  85. or visit their WEB page at http://www.wilmington.net/bmtmicro, or
  86. email to orders@bmt.wilmington.net.  You can also fax an order to
  87. them TOLL FREE at 800-346-1OS2 (1672).
  88.  
  89. BMT's "order" page can be web'd directly at:
  90.  
  91.     http://www.wilmington.net/bmtmicro/info/placeorder.html
  92.  
  93. NOTE:  BMT Micro also has an arrangment with a bank in GERMANY for
  94. European users who might find this useful.  Check the end of this 
  95. web page for details, please:
  96.  
  97.     http://www.wilmington.net/bmtmicro/info/payment.html
  98.  
  99.  
  100. NEW WAY FOR SCANDINAVIAN USERS TO REGISTER MR/2 ICE 
  101. ---------------------------------------------------
  102. You can now register MR/2 ICE via Berggreen Service, Denmark with 
  103. payment in Danish, Swedish and Norwegian Kroner. Berggreen Service 
  104. accepts checks or payment to Giro-accounts in Copenhagen, Stockholm
  105. and Oslo.
  106.  
  107. Write to berggreen@cybernet.dk or order online at:
  108.  
  109.     http://www.cybernet.dk/users/berggreen/os2/
  110.  
  111.  
  112. Register via COMPUSERVE - GO SWREG
  113. ----------------------------------
  114.  
  115. MR/2 ICE can now be registered through Compuserve's SWREG service.
  116. Simply type GO SWREG at any Compuserve command prompt and register
  117. package #11797.
  118.  
  119.  
  120.  
  121. Here's my registration policy:
  122. ------------------------------
  123.     
  124.     Register MR/2 ICE for $30 now.  It will possibly go a tad higher
  125.     if/when news is completed.  You will get emailed
  126.     a registration key that will prevent the 60-day nag screen and
  127.     will possibly (later) enable some control over other features
  128.     
  129.     Registration by an individual includes the capability of using
  130.     this registered copy at home and/or at work.  YOU are registered,
  131.     not a particular machine or system.
  132.     
  133.     I reserve the right to charge a nominal upgrade fee for future 
  134.     version, if enough functionality is added to warrant this. I have 
  135.     yet to do this with my QWK-based products, the text mode reader now 
  136.     at v2.25.
  137.         
  138.     I have devised a site license pricing tier.  You can always write
  139.     me for a discussion.  These are for licenses of MR/2 ICE running at
  140.     a single location (usually a company or other organization).
  141.  
  142.              5 User - $105
  143.             10 User - $190
  144.             25 User - $375
  145.             50 User - $500 ($3 per additional user)
  146.             
  147.             For each user above 50 add $3
  148.               (e.g., 200 user = $500+(150*3) = $950)
  149.         
  150.     All pricing is subject to change without notice.  We can
  151.     interpolate for in-between counts (e.g., 30 users at $415).
  152.     I'm basing these prices on a product I once purchased in this
  153.     manner.  I want to be reasonable, but still make a profit.
  154.     Email me for more detailed discussion.
  155.  
  156.     INCREMENTAL SITE LICENSES.  Those purchasing a site license may
  157.     increase the license count at some later date in time by submitting
  158.     the difference between the two licenses (based on what was 
  159.     originally paid vs. what the current total site license would 
  160.     cost), plus a flat modification fee of $10.
  161.                     
  162.     For example, a company purchases a 50 user site license at $425 under
  163.     old pricing.  A year later they wish to increase the license count to 
  164.     100 users.  They would sumbit a check or purchase order for 50 
  165.     incremental licenses at a cost of $235.  With the price increase to $500
  166.     for 50 users (where 100 users would be $650), the amount due would
  167.     be $235.  It's an easy calculation:
  168.                         
  169.         What you'd have to pay today for the total licenses desired
  170.       - What you've already paid
  171.       + $10.
  172.  
  173.     Since this is a "try before you buy" opportunity, I would expect
  174.     there to be no need to ever issue a refund.  Please consider all
  175.     sales final.
  176.     
  177.     Registration keys/licenses are NON TRANSFERABLE.
  178.  
  179.  
  180. ==========
  181. 3-Credits
  182. ==========
  183.  
  184. A massive THANK YOU to Andrew McElroy <andrewm@mcs.net> who authored the 
  185. HELP text and continues to improve it.  It is a monumental job, and 
  186. without him, I would have either no HELP text at all, or would have 
  187. delayed the release for quite some time.
  188.  
  189. Also, a big thanks to Cathy Quinones <quinones@mindspring.com> for 
  190. starting the HELP text off.  She documented much of the MENU hierarchy.
  191. Although this is unavailable in the first release (a menu help-hook
  192. is not in place yet), I expect to make full use her contribution soon.
  193.  
  194. And, I can't forgot all of my beta testers and mailing list 
  195. participants, many who have donated conversion routines, REXX scripts
  196. and all-around expert feedback throughout the beta cycle.
  197.  
  198. I'll also give much credit to Secant Technologies' wonderful programming 
  199. tools, and the staff as a whole who provided a wonderful, ready-made
  200. resource.
  201.  
  202.  
  203. ===================
  204. 4-LIST OF FEATURES
  205. ===================
  206.  
  207. o   POP3 or SMTP reads.
  208.  
  209. o   POP3 or SMTP sends.
  210.  
  211. o   Auto configures to existing IAK setup, when available.
  212.  
  213. o   Use of pop-up or "context" menus abound.  Try the right mouse button
  214.     in index lists, on toolbar buttons and in address fields.
  215.  
  216. o   Filters ... supports "simple" search criteria OR more powerful
  217.     free-form criteria allowing the testing of various message areas
  218.     (including specific header lines) with full boolean and/or/not.
  219.     Includes soundex capabilities and case sensitivity options.
  220.  
  221. o   Persistently sizable windows almost everwhere.  Multiple message
  222.     windows can each have different positions.
  223.  
  224. o   Toolbars w/bubble hints ("tooltips"), status bars, progression
  225.     indicators.  Optional whenever possible.  Hint bubble display and/or
  226.     delay configurable.  A RMB click will always display hints, if they
  227.     are turned on.
  228.     
  229. o   Font and color selection dialogs, as well as drag/drop support from
  230.     OS/2 pallets for message viewer windows.
  231.  
  232. o   Powerful message viewer and editor.  Things like a split screen
  233.     editor.  Spelling checker and thesaurus available (as separate files,
  234.     get the MR/2 QWK-reader files via www/ftp).  Simple things like Rot13
  235.     support and case conversions supported.  Mono/PS font toggle (you can 
  236.     configure the font for each mode).
  237.  
  238. o   Formatted *and* draft printing.
  239.  
  240. o   Selectable reply "templates" allow you to boiler-plate needed replies.
  241.     Powerful set of reply-time variables available.
  242.     
  243. o   Auto-checking for new messages via configurable time period.  Beeping
  244.     when mail arrives, and (optional) periodic beeping when new mail has
  245.     arrived and MR/2 has not acquired focus.  Minimized icon and task list
  246.     show new mail count.
  247.  
  248. o   Links to external utilities like WebExplorer and Ftp ... simply click,
  249.     RMB, click to load or ftp any URL embedded within a message.
  250.  
  251. o   MIME support with many configurable options.
  252.     
  253. o   UUEncoding/decoding.  Multiple files-per-message supported.
  254.  
  255. o   Address book with description, email address, notes and "tags".
  256.     Group addresses to with unlimitted address listings, including
  257.     nested groups/address book entries and lists from external files.
  258.  
  259. o   Pop up calendar (will be enhanced to provide to-do list/appointments).
  260.  
  261. o   Pop up calculator.
  262.  
  263. o   Multiple account support.
  264.  
  265. o   Sort message indexes to 3 levels (lots of options :).  Find text
  266.     in the message list
  267.     
  268. o   Dynamic window index ... easily find any open window and/or
  269.     messages index.
  270.     
  271. o   Many configurable options.  For example, turn on/off various 
  272.     warnings and prompts.
  273.     
  274. o   Auto-backup feature.  MR/2 ICE will recover most/all of any open
  275.     editor sessions if an application *or FULL SYSTEM* crash occur.
  276.     This includes lock-ups where a manual reboot has to be performed.
  277.     
  278. o   Clipboard access enhanced to include APPENDING to clipboard and
  279.     pasting *with* quote string.
  280.     
  281. o   Bcc's work the way they're *supposed* to :)
  282.  
  283.  
  284.  
  285. ==============
  286. 5-Quick Start
  287. ==============
  288.  
  289. Let's get to some simple instructions.  MR/2 ICE quick start:
  290.  
  291. o   Make a directory and unzip MR/2 ICE into it.  You may set up
  292.     a desktop icon to invoke MR/2 ICE or simply run it from the
  293.     command line.  When running MR/2 ICE for the first time, it
  294.     will jump right to the Network configuration screen.  Fill
  295.     this out carefully.  Press OK.
  296.     
  297. o   Once the network settings have been filled in, please select the
  298.     User Preferences tab and make any desired changes.  Close the window
  299.     by clicking in the corner.
  300.     
  301. o   You're ready to start.  MR/2 ICE will, by default, poll the POP3
  302.     server every 2 minutes.  Adjust accordingly.  Mail is kept in a
  303.     MAIL subdirectory of your MR/2 ICE software directory.
  304.     
  305. o   Command line switches:
  306.  
  307.         /Iinifile   Specifies a file where user interface
  308.                     settings (e.g., toolbar visibility and
  309.                     position, window positions) are kept.
  310.                     The default is mr2i.ini.
  311.                 
  312.         /Mmailcfg   Specifies the file in which to keep and
  313.                     access your EMail configuration.
  314.                 
  315.         /n          where n = 1, 2 or 3.  Starts MR/2 ICE on a 
  316.                     specified notebook page where 1 os the inbox
  317.                     (the default), 2 is the outbox and 3 is the
  318.                     folder page.
  319.         
  320.         /S          Suppresses the polling and delivery of
  321.                     email.  No network access is attempted.
  322.                     
  323.         /T          Toolbar-less operation.  Bypasses the crash
  324.                     caused by some bug in Soft & GUI's CmdLine.exe.
  325.                     
  326.         /L          Logs activity to mr2i.log - debugging information.
  327.  
  328.         /H          Causes MR/2 to change the default path to that
  329.                     of the mr2i.exe file just invoked.  In otherwords,
  330.                     the default path is changed to match the location
  331.                     of the file mr2i.exe being run.
  332.  
  333.         /Fn         Select a default font for custom control windows.
  334.                     (Necessary only if problems appear in install)
  335.                     
  336.         /Pnnn       Specify an alternate Pop3 port.
  337.         
  338.         /-          Minimize on start
  339.  
  340.         /X          Poll for new mail, exit.
  341.         
  342.         /XS         Poll for new mail, send any queued mail, exit.
  343.         
  344.         /Cn         Overrides the OS/2 Code page setting to n.
  345.         
  346.         /B          Advanced option: TCP/IP buffer sizes.  Defaults to 
  347.                     24000.
  348.         
  349.         /Qfile      Will add the names file to the MR/2 ICE outbox and 
  350.                     exit.  File is assumed to be a properly formed 
  351.                     message file.  You can force MR/2 to attempt to send 
  352.                     the message via use of the /XS flag.
  353.  
  354.         /Q file emailto subject
  355.         
  356.                     will copy file to a temp name (fax-oriented), MIME
  357.                     encode this file and add it to the outbox addressed
  358.                     to the specified user with the specified subject.
  359.                     
  360.         /Q *file emailto subject
  361.         
  362.                     will copy file to a temp name (fax-oriented),
  363.                     UUencode this file and add it to the outbox addressed
  364.                     to the specified user with the specified subject.
  365.  
  366.         /Q:file emailto subject
  367.         
  368.                     will MIME encode the named file into a new message,
  369.                     placing this message into the outbox, addressed
  370.                     to the specified user with the specified subject.
  371.                     
  372.         /Euser@domain
  373.         
  374.                     Starts MR/2 ICE and immediately invokes a new 
  375.                     message to the address specified.  For use by a 
  376.                     third-party address book program still in the works, 
  377.                     but it surely has other applications.
  378.                     
  379.         /D message [log]
  380.         
  381.                     where message is a filename containing a valid message
  382.                     with attachments.  Log file name is optional.  
  383.                     Detaches all attachments found in message, recording
  384.                     create file names in log.  Overwriting of existing
  385.                     files is automatic.
  386.                     
  387.         /W          Delete with safety.  Normally, MR/2 ICE bypassed any
  388.                     use of the DELDIR feature.  With /W specified, the
  389.                     OS/2 DELDIR mechanism is allowed to function.
  390.  
  391.  
  392. o   Command-line control of a running copy of MR/2 ICE.  The commands 
  393.     above will actually cause an existing instance of MR/2, if found,
  394.     to do the desired work.  I went the extra step of support this for
  395.     multiple accounts, so specifying an account should talk to the right
  396.     copy of MR/2 ICE.  So, using the /Q option to queue a file actually
  397.     puts it in the outbox of a running copy, and proceeds to send it.
  398.     Using the /E option causes a New Message header screen to pop to the 
  399.     desktop from a running copy of ICE.  Also:
  400.     
  401.         /Qfile  - as described above
  402.         
  403.         /Euser@domain - as described above        
  404.  
  405.         /+  will restore and bring focus to a minimized/burried 
  406.             copy of MR/2 ICE.
  407.             
  408.         /-  will minimize an existing, running copy of MR/2 ICE.
  409.         
  410.                 
  411. o   New message:  Click on the first toolbar icon, or select NEW
  412.     from the File menu.
  413.     
  414.     Fill out the header editing screen and press OK.  Now, type
  415.     in the message and press SEND.  Depending on the options in
  416.     your User Preference settings, you may be shown the header
  417.     editing screen again.  Press OK to send it.
  418.     
  419. o   Replying:  Viewing any message, press on the REPLY button.
  420.     You will be prompted with the Header Editing screen (optionally),
  421.     the allowed to edit the reply.  The simple editor allows you
  422.     to toggle back to the original (the "<" button) and then
  423.     forward to the reply (the ">" button).  It also allows you to
  424.     split the screen and show both windows (the "-" button").
  425.  
  426. o   When incoming messages are first displayed, an empty checkbox
  427.     icon is next to them ("fresh" incoming mail is colored in red
  428.     text, too).  Once read, a black check mark is attached.  If
  429.     you reply, the message is marked with a RED checkmark.
  430.  
  431. o   The Out Box shows all messages sent.
  432.  
  433. o   The Right Mouse Button (RMB) is used often.  Try it inside message
  434.     index lists, on toolbar buttons, and inside address fields.
  435.  
  436. o   Selecting message(s).  Mark the message(s) you want to open with the 
  437.     mouse and use the RMB to call up the popup menu (or use the main 
  438.     menu).  Click on OPEN.  Alternately, double click on any single 
  439.     message will to open it.
  440.         
  441. o   Outbox:  Unsent messages have a mailbox icon.  Sent message switch to
  442.     an envelope icon.  There is a resend option on the popup menu (RMB)
  443.     and on the viewer screen.  Resending fron the viewer screen provides
  444.     an optional chance to modify the message first.
  445.  
  446.  
  447.  
  448. ========================
  449. 6-CONTACTING THE AUTHOR
  450. ========================
  451.  
  452. You  can contact me in a number  of ways.  Unfortunately, I can't
  453. provide a phone number at this time.
  454.  
  455. US Mail:        Nick Knight
  456.                 P.O. Box 22366
  457.                 Beachwood, Ohio 44122
  458.  
  459. Web:            http://nick.secant.com (Includes MR/2 ICE FAQ)
  460.  
  461. Fax:            (216) 595-0199 (Secant Technologies' fax)
  462.  
  463. Fido netmail:   1:157/2 to "Nick Knight"
  464.  
  465. Internet:       nick@secant.com
  466.            
  467. Fido Echomail:  Echomail messages to me in general conferences are 
  468.                 discouraged, as keeping them "on topic" and interesting 
  469.                 to the masses would be difficult.  I do read OS2, 
  470.                 OS2PROG, C_PLUSPLUS and DR DEBUG daily, though.  OFFLINE 
  471.                 echo also (deals with mail readers), this might be THE 
  472.                 place to ask public questions, eh?
  473.  
  474.                 I recently have acquired access to a host of other 
  475.                 networks with OS/2 and OFFLINE conferences.  These 
  476.                 include RIME, SmartNet, Uninet, Intelec, Nanonet, 
  477.                 Racenet and some others I can't remember.
  478.  
  479. Direct BBS:     Leave a message on the Nerd's Nook BBS (1:157/2) at (216) 
  480.                 356-1772, 356-1872 or 356-1431.  I check in here multiple 
  481.                 times a day.  I will also keep the most recent copy of 
  482.                 MR/2 posted here.  Other boards (non-local) will get 
  483.                 updates at my convenience.
  484.  
  485. Internet FTP:   I have an anonymous FTP "site" setup as a directory on my 
  486.                 machine.  Ftp to nick.secant.com.  You can upload bugs, 
  487.                 packets, notes, whatever into the incoming directory.
  488.  
  489. Compuserve:     I check a couple of times a week or thereabouts.  Try 
  490.                 mail to my user ID  - 76066,1240, although internet 
  491.                 mail has proven to be a faster approach.
  492.  
  493.     
  494.  
  495. =========================================
  496. 7-KNOWN BUGS/PROBLEMS - MISSING FEATURES
  497. =========================================
  498.  
  499. o   Help is still work-in-progress.  Part is coding, part is more
  500.     help text and polish.
  501.     
  502. o   Filters:  Auto-Forward incomplete at this time.
  503.  
  504. o   Still many areas that need optimization and minor rework/threading for
  505.     performance reasons.  For example: formatted printing AND pop purges.
  506.     
  507. o   Various bugs with the editor when in split mode and options like
  508.     show/hide toolbar or pushbuttons are used.
  509.  
  510.  
  511.